home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Resources / Chat & Communication / Digsby build 37 / digsby_setup.exe / lib / optparse.pyo (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-13  |  39KB  |  1,247 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyo (Python 2.5)
  3.  
  4. __version__ = '1.5.3'
  5. __all__ = [
  6.     'Option',
  7.     'SUPPRESS_HELP',
  8.     'SUPPRESS_USAGE',
  9.     'Values',
  10.     'OptionContainer',
  11.     'OptionGroup',
  12.     'OptionParser',
  13.     'HelpFormatter',
  14.     'IndentedHelpFormatter',
  15.     'TitledHelpFormatter',
  16.     'OptParseError',
  17.     'OptionError',
  18.     'OptionConflictError',
  19.     'OptionValueError',
  20.     'BadOptionError']
  21. __copyright__ = '\nCopyright (c) 2001-2006 Gregory P. Ward.  All rights reserved.\nCopyright (c) 2002-2006 Python Software Foundation.  All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n  * Redistributions of source code must retain the above copyright\n    notice, this list of conditions and the following disclaimer.\n\n  * Redistributions in binary form must reproduce the above copyright\n    notice, this list of conditions and the following disclaimer in the\n    documentation and/or other materials provided with the distribution.\n\n  * Neither the name of the author nor the names of its\n    contributors may be used to endorse or promote products derived from\n    this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS\nIS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR\nCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n'
  22. import sys
  23. import os
  24. import types
  25. import textwrap
  26.  
  27. def _repr(self):
  28.     return '<%s at 0x%x: %s>' % (self.__class__.__name__, id(self), self)
  29.  
  30.  
  31. try:
  32.     from gettext import gettext
  33. except ImportError:
  34.     
  35.     def gettext(message):
  36.         return message
  37.  
  38.  
  39. _ = gettext
  40.  
  41. class OptParseError(Exception):
  42.     
  43.     def __init__(self, msg):
  44.         self.msg = msg
  45.  
  46.     
  47.     def __str__(self):
  48.         return self.msg
  49.  
  50.  
  51.  
  52. class OptionError(OptParseError):
  53.     
  54.     def __init__(self, msg, option):
  55.         self.msg = msg
  56.         self.option_id = str(option)
  57.  
  58.     
  59.     def __str__(self):
  60.         if self.option_id:
  61.             return 'option %s: %s' % (self.option_id, self.msg)
  62.         else:
  63.             return self.msg
  64.  
  65.  
  66.  
  67. class OptionConflictError(OptionError):
  68.     pass
  69.  
  70.  
  71. class OptionValueError(OptParseError):
  72.     pass
  73.  
  74.  
  75. class BadOptionError(OptParseError):
  76.     
  77.     def __init__(self, opt_str):
  78.         self.opt_str = opt_str
  79.  
  80.     
  81.     def __str__(self):
  82.         return _('no such option: %s') % self.opt_str
  83.  
  84.  
  85.  
  86. class AmbiguousOptionError(BadOptionError):
  87.     
  88.     def __init__(self, opt_str, possibilities):
  89.         BadOptionError.__init__(self, opt_str)
  90.         self.possibilities = possibilities
  91.  
  92.     
  93.     def __str__(self):
  94.         return _('ambiguous option: %s (%s?)') % (self.opt_str, ', '.join(self.possibilities))
  95.  
  96.  
  97.  
  98. class HelpFormatter:
  99.     NO_DEFAULT_VALUE = 'none'
  100.     
  101.     def __init__(self, indent_increment, max_help_position, width, short_first):
  102.         self.parser = None
  103.         self.indent_increment = indent_increment
  104.         self.help_position = self.max_help_position = max_help_position
  105.         if width is None:
  106.             
  107.             try:
  108.                 width = int(os.environ['COLUMNS'])
  109.             except (KeyError, ValueError):
  110.                 width = 80
  111.  
  112.             width -= 2
  113.         
  114.         self.width = width
  115.         self.current_indent = 0
  116.         self.level = 0
  117.         self.help_width = None
  118.         self.short_first = short_first
  119.         self.default_tag = '%default'
  120.         self.option_strings = { }
  121.         self._short_opt_fmt = '%s %s'
  122.         self._long_opt_fmt = '%s=%s'
  123.  
  124.     
  125.     def set_parser(self, parser):
  126.         self.parser = parser
  127.  
  128.     
  129.     def set_short_opt_delimiter(self, delim):
  130.         if delim not in ('', ' '):
  131.             raise ValueError('invalid metavar delimiter for short options: %r' % delim)
  132.         
  133.         self._short_opt_fmt = '%s' + delim + '%s'
  134.  
  135.     
  136.     def set_long_opt_delimiter(self, delim):
  137.         if delim not in ('=', ' '):
  138.             raise ValueError('invalid metavar delimiter for long options: %r' % delim)
  139.         
  140.         self._long_opt_fmt = '%s' + delim + '%s'
  141.  
  142.     
  143.     def indent(self):
  144.         self.current_indent += self.indent_increment
  145.         self.level += 1
  146.  
  147.     
  148.     def dedent(self):
  149.         self.current_indent -= self.indent_increment
  150.         self.level -= 1
  151.  
  152.     
  153.     def format_usage(self, usage):
  154.         raise NotImplementedError, 'subclasses must implement'
  155.  
  156.     
  157.     def format_heading(self, heading):
  158.         raise NotImplementedError, 'subclasses must implement'
  159.  
  160.     
  161.     def _format_text(self, text):
  162.         text_width = self.width - self.current_indent
  163.         indent = ' ' * self.current_indent
  164.         return textwrap.fill(text, text_width, initial_indent = indent, subsequent_indent = indent)
  165.  
  166.     
  167.     def format_description(self, description):
  168.         if description:
  169.             return self._format_text(description) + '\n'
  170.         else:
  171.             return ''
  172.  
  173.     
  174.     def format_epilog(self, epilog):
  175.         if epilog:
  176.             return '\n' + self._format_text(epilog) + '\n'
  177.         else:
  178.             return ''
  179.  
  180.     
  181.     def expand_default(self, option):
  182.         if self.parser is None or not (self.default_tag):
  183.             return option.help
  184.         
  185.         default_value = self.parser.defaults.get(option.dest)
  186.         if default_value is NO_DEFAULT or default_value is None:
  187.             default_value = self.NO_DEFAULT_VALUE
  188.         
  189.         return option.help.replace(self.default_tag, str(default_value))
  190.  
  191.     
  192.     def format_option(self, option):
  193.         result = []
  194.         opts = self.option_strings[option]
  195.         opt_width = self.help_position - self.current_indent - 2
  196.         if len(opts) > opt_width:
  197.             opts = '%*s%s\n' % (self.current_indent, '', opts)
  198.             indent_first = self.help_position
  199.         else:
  200.             opts = '%*s%-*s  ' % (self.current_indent, '', opt_width, opts)
  201.             indent_first = 0
  202.         result.append(opts)
  203.         if option.help:
  204.             help_text = self.expand_default(option)
  205.             help_lines = textwrap.wrap(help_text, self.help_width)
  206.             result.append('%*s%s\n' % (indent_first, '', help_lines[0]))
  207.             []([ '%*s%s\n' % (self.help_position, '', line) for line in help_lines[1:] ])
  208.         elif opts[-1] != '\n':
  209.             result.append('\n')
  210.         
  211.         return ''.join(result)
  212.  
  213.     
  214.     def store_option_strings(self, parser):
  215.         self.indent()
  216.         max_len = 0
  217.         for opt in parser.option_list:
  218.             strings = self.format_option_strings(opt)
  219.             self.option_strings[opt] = strings
  220.             max_len = max(max_len, len(strings) + self.current_indent)
  221.         
  222.         self.indent()
  223.         for group in parser.option_groups:
  224.             for opt in group.option_list:
  225.                 strings = self.format_option_strings(opt)
  226.                 self.option_strings[opt] = strings
  227.                 max_len = max(max_len, len(strings) + self.current_indent)
  228.             
  229.         
  230.         self.dedent()
  231.         self.dedent()
  232.         self.help_position = min(max_len + 2, self.max_help_position)
  233.         self.help_width = self.width - self.help_position
  234.  
  235.     
  236.     def format_option_strings(self, option):
  237.         return ', '.join(opts)
  238.  
  239.  
  240.  
  241. class IndentedHelpFormatter(HelpFormatter):
  242.     
  243.     def __init__(self, indent_increment = 2, max_help_position = 24, width = None, short_first = 1):
  244.         HelpFormatter.__init__(self, indent_increment, max_help_position, width, short_first)
  245.  
  246.     
  247.     def format_usage(self, usage):
  248.         return _('Usage: %s\n') % usage
  249.  
  250.     
  251.     def format_heading(self, heading):
  252.         return '%*s%s:\n' % (self.current_indent, '', heading)
  253.  
  254.  
  255.  
  256. class TitledHelpFormatter(HelpFormatter):
  257.     
  258.     def __init__(self, indent_increment = 0, max_help_position = 24, width = None, short_first = 0):
  259.         HelpFormatter.__init__(self, indent_increment, max_help_position, width, short_first)
  260.  
  261.     
  262.     def format_usage(self, usage):
  263.         return '%s  %s\n' % (self.format_heading(_('Usage')), usage)
  264.  
  265.     
  266.     def format_heading(self, heading):
  267.         return '%s\n%s\n' % (heading, '=-'[self.level] * len(heading))
  268.  
  269.  
  270.  
  271. def _parse_num(val, type):
  272.     if val[:2].lower() == '0x':
  273.         radix = 16
  274.     elif val[:2].lower() == '0b':
  275.         radix = 2
  276.         if not val[2:]:
  277.             pass
  278.         val = '0'
  279.     elif val[:1] == '0':
  280.         radix = 8
  281.     else:
  282.         radix = 10
  283.     return type(val, radix)
  284.  
  285.  
  286. def _parse_int(val):
  287.     return _parse_num(val, int)
  288.  
  289.  
  290. def _parse_long(val):
  291.     return _parse_num(val, long)
  292.  
  293. _builtin_cvt = {
  294.     'int': (_parse_int, _('integer')),
  295.     'long': (_parse_long, _('long integer')),
  296.     'float': (float, _('floating-point')),
  297.     'complex': (complex, _('complex')) }
  298.  
  299. def check_builtin(option, opt, value):
  300.     (cvt, what) = _builtin_cvt[option.type]
  301.     
  302.     try:
  303.         return cvt(value)
  304.     except ValueError:
  305.         raise OptionValueError(_('option %s: invalid %s value: %r') % (opt, what, value))
  306.  
  307.  
  308.  
  309. def check_choice(option, opt, value):
  310.     if value in option.choices:
  311.         return value
  312.     else:
  313.         choices = ', '.join(map(repr, option.choices))
  314.         raise OptionValueError(_('option %s: invalid choice: %r (choose from %s)') % (opt, value, choices))
  315.  
  316. NO_DEFAULT = ('NO', 'DEFAULT')
  317.  
  318. class Option:
  319.     ATTRS = [
  320.         'action',
  321.         'type',
  322.         'dest',
  323.         'default',
  324.         'nargs',
  325.         'const',
  326.         'choices',
  327.         'callback',
  328.         'callback_args',
  329.         'callback_kwargs',
  330.         'help',
  331.         'metavar']
  332.     ACTIONS = ('store', 'store_const', 'store_true', 'store_false', 'append', 'append_const', 'count', 'callback', 'help', 'version')
  333.     STORE_ACTIONS = ('store', 'store_const', 'store_true', 'store_false', 'append', 'append_const', 'count')
  334.     TYPED_ACTIONS = ('store', 'append', 'callback')
  335.     ALWAYS_TYPED_ACTIONS = ('store', 'append')
  336.     CONST_ACTIONS = ('store_const', 'append_const')
  337.     TYPES = ('string', 'int', 'long', 'float', 'complex', 'choice')
  338.     TYPE_CHECKER = {
  339.         'int': check_builtin,
  340.         'long': check_builtin,
  341.         'float': check_builtin,
  342.         'complex': check_builtin,
  343.         'choice': check_choice }
  344.     CHECK_METHODS = None
  345.     
  346.     def __init__(self, *opts, **attrs):
  347.         self._short_opts = []
  348.         self._long_opts = []
  349.         opts = self._check_opt_strings(opts)
  350.         self._set_opt_strings(opts)
  351.         self._set_attrs(attrs)
  352.         for checker in self.CHECK_METHODS:
  353.             checker(self)
  354.         
  355.  
  356.     
  357.     def _check_opt_strings(self, opts):
  358.         opts = filter(None, opts)
  359.         if not opts:
  360.             raise TypeError('at least one option string must be supplied')
  361.         
  362.         return opts
  363.  
  364.     
  365.     def _set_opt_strings(self, opts):
  366.         for opt in opts:
  367.             if len(opt) < 2:
  368.                 raise OptionError('invalid option string %r: must be at least two characters long' % opt, self)
  369.                 continue
  370.             if len(opt) == 2:
  371.                 if not opt[0] == '-' and opt[1] != '-':
  372.                     raise OptionError('invalid short option string %r: must be of the form -x, (x any non-dash char)' % opt, self)
  373.                 
  374.                 self._short_opts.append(opt)
  375.                 continue
  376.             if not opt[0:2] == '--' and opt[2] != '-':
  377.                 raise OptionError('invalid long option string %r: must start with --, followed by non-dash' % opt, self)
  378.             
  379.             self._long_opts.append(opt)
  380.         
  381.  
  382.     
  383.     def _set_attrs(self, attrs):
  384.         for attr in self.ATTRS:
  385.             if attrs.has_key(attr):
  386.                 setattr(self, attr, attrs[attr])
  387.                 del attrs[attr]
  388.                 continue
  389.             if attr == 'default':
  390.                 setattr(self, attr, NO_DEFAULT)
  391.                 continue
  392.             setattr(self, attr, None)
  393.         
  394.         if attrs:
  395.             attrs = attrs.keys()
  396.             attrs.sort()
  397.             raise OptionError('invalid keyword arguments: %s' % ', '.join(attrs), self)
  398.         
  399.  
  400.     
  401.     def _check_action(self):
  402.         if self.action is None:
  403.             self.action = 'store'
  404.         elif self.action not in self.ACTIONS:
  405.             raise OptionError('invalid action: %r' % self.action, self)
  406.         
  407.  
  408.     
  409.     def _check_type(self):
  410.         if self.type is None:
  411.             if self.action in self.ALWAYS_TYPED_ACTIONS:
  412.                 if self.choices is not None:
  413.                     self.type = 'choice'
  414.                 else:
  415.                     self.type = 'string'
  416.             
  417.         else:
  418.             import __builtin__ as __builtin__
  419.             if (type(self.type) is types.TypeType or hasattr(self.type, '__name__')) and getattr(__builtin__, self.type.__name__, None) is self.type:
  420.                 self.type = self.type.__name__
  421.             
  422.             if self.type == 'str':
  423.                 self.type = 'string'
  424.             
  425.             if self.type not in self.TYPES:
  426.                 raise OptionError('invalid option type: %r' % self.type, self)
  427.             
  428.             if self.action not in self.TYPED_ACTIONS:
  429.                 raise OptionError('must not supply a type for action %r' % self.action, self)
  430.             
  431.  
  432.     
  433.     def _check_choice(self):
  434.         if self.type == 'choice':
  435.             if self.choices is None:
  436.                 raise OptionError("must supply a list of choices for type 'choice'", self)
  437.             elif type(self.choices) not in (types.TupleType, types.ListType):
  438.                 raise OptionError("choices must be a list of strings ('%s' supplied)" % str(type(self.choices)).split("'")[1], self)
  439.             
  440.         elif self.choices is not None:
  441.             raise OptionError('must not supply choices for type %r' % self.type, self)
  442.         
  443.  
  444.     
  445.     def _check_dest(self):
  446.         if not self.action in self.STORE_ACTIONS:
  447.             pass
  448.         takes_value = self.type is not None
  449.         if self.dest is None and takes_value:
  450.             if self._long_opts:
  451.                 self.dest = self._long_opts[0][2:].replace('-', '_')
  452.             else:
  453.                 self.dest = self._short_opts[0][1]
  454.         
  455.  
  456.     
  457.     def _check_const(self):
  458.         if self.action not in self.CONST_ACTIONS and self.const is not None:
  459.             raise OptionError("'const' must not be supplied for action %r" % self.action, self)
  460.         
  461.  
  462.     
  463.     def _check_nargs(self):
  464.         if self.action in self.TYPED_ACTIONS:
  465.             if self.nargs is None:
  466.                 self.nargs = 1
  467.             
  468.         elif self.nargs is not None:
  469.             raise OptionError("'nargs' must not be supplied for action %r" % self.action, self)
  470.         
  471.  
  472.     
  473.     def _check_callback(self):
  474.         if self.action == 'callback':
  475.             if not callable(self.callback):
  476.                 raise OptionError('callback not callable: %r' % self.callback, self)
  477.             
  478.             if self.callback_args is not None and type(self.callback_args) is not types.TupleType:
  479.                 raise OptionError('callback_args, if supplied, must be a tuple: not %r' % self.callback_args, self)
  480.             
  481.             if self.callback_kwargs is not None and type(self.callback_kwargs) is not types.DictType:
  482.                 raise OptionError('callback_kwargs, if supplied, must be a dict: not %r' % self.callback_kwargs, self)
  483.             
  484.         elif self.callback is not None:
  485.             raise OptionError('callback supplied (%r) for non-callback option' % self.callback, self)
  486.         
  487.         if self.callback_args is not None:
  488.             raise OptionError('callback_args supplied for non-callback option', self)
  489.         
  490.         if self.callback_kwargs is not None:
  491.             raise OptionError('callback_kwargs supplied for non-callback option', self)
  492.         
  493.  
  494.     CHECK_METHODS = [
  495.         _check_action,
  496.         _check_type,
  497.         _check_choice,
  498.         _check_dest,
  499.         _check_const,
  500.         _check_nargs,
  501.         _check_callback]
  502.     
  503.     def __str__(self):
  504.         return '/'.join(self._short_opts + self._long_opts)
  505.  
  506.     __repr__ = _repr
  507.     
  508.     def takes_value(self):
  509.         return self.type is not None
  510.  
  511.     
  512.     def get_opt_string(self):
  513.         if self._long_opts:
  514.             return self._long_opts[0]
  515.         else:
  516.             return self._short_opts[0]
  517.  
  518.     
  519.     def check_value(self, opt, value):
  520.         checker = self.TYPE_CHECKER.get(self.type)
  521.         if checker is None:
  522.             return value
  523.         else:
  524.             return checker(self, opt, value)
  525.  
  526.     
  527.     def convert_value(self, opt, value):
  528.         pass
  529.  
  530.     
  531.     def process(self, opt, value, values, parser):
  532.         value = self.convert_value(opt, value)
  533.         return self.take_action(self.action, self.dest, opt, value, values, parser)
  534.  
  535.     
  536.     def take_action(self, action, dest, opt, value, values, parser):
  537.         if action == 'store':
  538.             setattr(values, dest, value)
  539.         elif action == 'store_const':
  540.             setattr(values, dest, self.const)
  541.         elif action == 'store_true':
  542.             setattr(values, dest, True)
  543.         elif action == 'store_false':
  544.             setattr(values, dest, False)
  545.         elif action == 'append':
  546.             values.ensure_value(dest, []).append(value)
  547.         elif action == 'append_const':
  548.             values.ensure_value(dest, []).append(self.const)
  549.         elif action == 'count':
  550.             setattr(values, dest, values.ensure_value(dest, 0) + 1)
  551.         elif action == 'callback':
  552.             if not self.callback_args:
  553.                 pass
  554.             args = ()
  555.             if not self.callback_kwargs:
  556.                 pass
  557.             kwargs = { }
  558.             self.callback(self, opt, value, parser, *args, **kwargs)
  559.         elif action == 'help':
  560.             parser.print_help()
  561.             parser.exit()
  562.         elif action == 'version':
  563.             parser.print_version()
  564.             parser.exit()
  565.         else:
  566.             raise RuntimeError, 'unknown action %r' % self.action
  567.         return 1
  568.  
  569.  
  570. SUPPRESS_HELP = 'SUPPRESS' + 'HELP'
  571. SUPPRESS_USAGE = 'SUPPRESS' + 'USAGE'
  572.  
  573. try:
  574.     (True, False)
  575. except NameError:
  576.     (True, False) = (1, 0)
  577.  
  578.  
  579. try:
  580.     basestring
  581. except NameError:
  582.     
  583.     def isbasestring(x):
  584.         return isinstance(x, (types.StringType, types.UnicodeType))
  585.  
  586.  
  587.  
  588. def isbasestring(x):
  589.     return isinstance(x, basestring)
  590.  
  591.  
  592. class Values:
  593.     
  594.     def __init__(self, defaults = None):
  595.         if defaults:
  596.             for attr, val in defaults.items():
  597.                 setattr(self, attr, val)
  598.             
  599.         
  600.  
  601.     
  602.     def __str__(self):
  603.         return str(self.__dict__)
  604.  
  605.     __repr__ = _repr
  606.     
  607.     def __cmp__(self, other):
  608.         if isinstance(other, Values):
  609.             return cmp(self.__dict__, other.__dict__)
  610.         elif isinstance(other, types.DictType):
  611.             return cmp(self.__dict__, other)
  612.         else:
  613.             return -1
  614.  
  615.     
  616.     def _update_careful(self, dict):
  617.         for attr in dir(self):
  618.             if dict.has_key(attr):
  619.                 dval = dict[attr]
  620.                 if dval is not None:
  621.                     setattr(self, attr, dval)
  622.                 
  623.             dval is not None
  624.         
  625.  
  626.     
  627.     def _update_loose(self, dict):
  628.         self.__dict__.update(dict)
  629.  
  630.     
  631.     def _update(self, dict, mode):
  632.         if mode == 'careful':
  633.             self._update_careful(dict)
  634.         elif mode == 'loose':
  635.             self._update_loose(dict)
  636.         else:
  637.             raise ValueError, 'invalid update mode: %r' % mode
  638.  
  639.     
  640.     def read_module(self, modname, mode = 'careful'):
  641.         __import__(modname)
  642.         mod = sys.modules[modname]
  643.         self._update(vars(mod), mode)
  644.  
  645.     
  646.     def read_file(self, filename, mode = 'careful'):
  647.         vars = { }
  648.         execfile(filename, vars)
  649.         self._update(vars, mode)
  650.  
  651.     
  652.     def ensure_value(self, attr, value):
  653.         if not hasattr(self, attr) or getattr(self, attr) is None:
  654.             setattr(self, attr, value)
  655.         
  656.         return getattr(self, attr)
  657.  
  658.  
  659.  
  660. class OptionContainer:
  661.     
  662.     def __init__(self, option_class, conflict_handler, description):
  663.         self._create_option_list()
  664.         self.option_class = option_class
  665.         self.set_conflict_handler(conflict_handler)
  666.         self.set_description(description)
  667.  
  668.     
  669.     def _create_option_mappings(self):
  670.         self._short_opt = { }
  671.         self._long_opt = { }
  672.         self.defaults = { }
  673.  
  674.     
  675.     def _share_option_mappings(self, parser):
  676.         self._short_opt = parser._short_opt
  677.         self._long_opt = parser._long_opt
  678.         self.defaults = parser.defaults
  679.  
  680.     
  681.     def set_conflict_handler(self, handler):
  682.         if handler not in ('error', 'resolve'):
  683.             raise ValueError, 'invalid conflict_resolution value %r' % handler
  684.         
  685.         self.conflict_handler = handler
  686.  
  687.     
  688.     def set_description(self, description):
  689.         self.description = description
  690.  
  691.     
  692.     def get_description(self):
  693.         return self.description
  694.  
  695.     
  696.     def destroy(self):
  697.         del self._short_opt
  698.         del self._long_opt
  699.         del self.defaults
  700.  
  701.     
  702.     def _check_conflict(self, option):
  703.         conflict_opts = []
  704.         for opt in option._short_opts:
  705.             if self._short_opt.has_key(opt):
  706.                 conflict_opts.append((opt, self._short_opt[opt]))
  707.                 continue
  708.         
  709.         for opt in option._long_opts:
  710.             if self._long_opt.has_key(opt):
  711.                 conflict_opts.append((opt, self._long_opt[opt]))
  712.                 continue
  713.         
  714.         if conflict_opts:
  715.             handler = self.conflict_handler
  716.             if handler == 'error':
  717.                 raise ', '.join([] % []([ co[0] for co in conflict_opts ]), option)
  718.             elif handler == 'resolve':
  719.                 for opt, c_option in conflict_opts:
  720.                     if opt.startswith('--'):
  721.                         c_option._long_opts.remove(opt)
  722.                         del self._long_opt[opt]
  723.                     else:
  724.                         c_option._short_opts.remove(opt)
  725.                         del self._short_opt[opt]
  726.                     if not c_option._short_opts or c_option._long_opts:
  727.                         c_option.container.option_list.remove(c_option)
  728.                         continue
  729.                 
  730.             
  731.         
  732.  
  733.     
  734.     def add_option(self, *args, **kwargs):
  735.         if type(args[0]) is types.StringType:
  736.             option = self.option_class(*args, **kwargs)
  737.         elif len(args) == 1 and not kwargs:
  738.             option = args[0]
  739.             if not isinstance(option, Option):
  740.                 raise TypeError, 'not an Option instance: %r' % option
  741.             
  742.         else:
  743.             raise TypeError, 'invalid arguments'
  744.         self._check_conflict(option)
  745.         self.option_list.append(option)
  746.         option.container = self
  747.         for opt in option._short_opts:
  748.             self._short_opt[opt] = option
  749.         
  750.         for opt in option._long_opts:
  751.             self._long_opt[opt] = option
  752.         
  753.         if option.dest is not None:
  754.             if option.default is not NO_DEFAULT:
  755.                 self.defaults[option.dest] = option.default
  756.             elif not self.defaults.has_key(option.dest):
  757.                 self.defaults[option.dest] = None
  758.             
  759.         
  760.         return option
  761.  
  762.     
  763.     def add_options(self, option_list):
  764.         for option in option_list:
  765.             self.add_option(option)
  766.         
  767.  
  768.     
  769.     def get_option(self, opt_str):
  770.         if not self._short_opt.get(opt_str):
  771.             pass
  772.         return self._long_opt.get(opt_str)
  773.  
  774.     
  775.     def has_option(self, opt_str):
  776.         if not self._short_opt.has_key(opt_str):
  777.             pass
  778.         return self._long_opt.has_key(opt_str)
  779.  
  780.     
  781.     def remove_option(self, opt_str):
  782.         option = self._short_opt.get(opt_str)
  783.         if option is None:
  784.             option = self._long_opt.get(opt_str)
  785.         
  786.         if option is None:
  787.             raise ValueError('no such option %r' % opt_str)
  788.         
  789.         for opt in option._short_opts:
  790.             del self._short_opt[opt]
  791.         
  792.         for opt in option._long_opts:
  793.             del self._long_opt[opt]
  794.         
  795.         option.container.option_list.remove(option)
  796.  
  797.     
  798.     def format_option_help(self, formatter):
  799.         if not self.option_list:
  800.             return ''
  801.         
  802.         result = []
  803.         for option in self.option_list:
  804.             if option.help is not SUPPRESS_HELP:
  805.                 result.append(formatter.format_option(option))
  806.                 continue
  807.         
  808.         return ''.join(result)
  809.  
  810.     
  811.     def format_description(self, formatter):
  812.         return formatter.format_description(self.get_description())
  813.  
  814.     
  815.     def format_help(self, formatter):
  816.         result = []
  817.         if self.description:
  818.             result.append(self.format_description(formatter))
  819.         
  820.         if self.option_list:
  821.             result.append(self.format_option_help(formatter))
  822.         
  823.         return '\n'.join(result)
  824.  
  825.  
  826.  
  827. class OptionGroup(OptionContainer):
  828.     
  829.     def __init__(self, parser, title, description = None):
  830.         self.parser = parser
  831.         OptionContainer.__init__(self, parser.option_class, parser.conflict_handler, description)
  832.         self.title = title
  833.  
  834.     
  835.     def _create_option_list(self):
  836.         self.option_list = []
  837.         self._share_option_mappings(self.parser)
  838.  
  839.     
  840.     def set_title(self, title):
  841.         self.title = title
  842.  
  843.     
  844.     def destroy(self):
  845.         OptionContainer.destroy(self)
  846.         del self.option_list
  847.  
  848.     
  849.     def format_help(self, formatter):
  850.         result = formatter.format_heading(self.title)
  851.         formatter.indent()
  852.         result += OptionContainer.format_help(self, formatter)
  853.         formatter.dedent()
  854.         return result
  855.  
  856.  
  857.  
  858. class OptionParser(OptionContainer):
  859.     standard_option_list = []
  860.     
  861.     def __init__(self, usage = None, option_list = None, option_class = Option, version = None, conflict_handler = 'error', description = None, formatter = None, add_help_option = True, prog = None, epilog = None):
  862.         OptionContainer.__init__(self, option_class, conflict_handler, description)
  863.         self.set_usage(usage)
  864.         self.prog = prog
  865.         self.version = version
  866.         self.allow_interspersed_args = True
  867.         self.process_default_values = True
  868.         if formatter is None:
  869.             formatter = IndentedHelpFormatter()
  870.         
  871.         self.formatter = formatter
  872.         self.formatter.set_parser(self)
  873.         self.epilog = epilog
  874.         self._populate_option_list(option_list, add_help = add_help_option)
  875.         self._init_parsing_state()
  876.  
  877.     
  878.     def destroy(self):
  879.         OptionContainer.destroy(self)
  880.         for group in self.option_groups:
  881.             group.destroy()
  882.         
  883.         del self.option_list
  884.         del self.option_groups
  885.         del self.formatter
  886.  
  887.     
  888.     def _create_option_list(self):
  889.         self.option_list = []
  890.         self.option_groups = []
  891.         self._create_option_mappings()
  892.  
  893.     
  894.     def _add_help_option(self):
  895.         self.add_option('-h', '--help', action = 'help', help = _('show this help message and exit'))
  896.  
  897.     
  898.     def _add_version_option(self):
  899.         self.add_option('--version', action = 'version', help = _("show program's version number and exit"))
  900.  
  901.     
  902.     def _populate_option_list(self, option_list, add_help = True):
  903.         if self.standard_option_list:
  904.             self.add_options(self.standard_option_list)
  905.         
  906.         if option_list:
  907.             self.add_options(option_list)
  908.         
  909.         if self.version:
  910.             self._add_version_option()
  911.         
  912.         if add_help:
  913.             self._add_help_option()
  914.         
  915.  
  916.     
  917.     def _init_parsing_state(self):
  918.         self.rargs = None
  919.         self.largs = None
  920.         self.values = None
  921.  
  922.     
  923.     def set_usage(self, usage):
  924.         if usage is None:
  925.             self.usage = _('%prog [options]')
  926.         elif usage is SUPPRESS_USAGE:
  927.             self.usage = None
  928.         elif usage.lower().startswith('usage: '):
  929.             self.usage = usage[7:]
  930.         else:
  931.             self.usage = usage
  932.  
  933.     
  934.     def enable_interspersed_args(self):
  935.         self.allow_interspersed_args = True
  936.  
  937.     
  938.     def disable_interspersed_args(self):
  939.         self.allow_interspersed_args = False
  940.  
  941.     
  942.     def set_process_default_values(self, process):
  943.         self.process_default_values = process
  944.  
  945.     
  946.     def set_default(self, dest, value):
  947.         self.defaults[dest] = value
  948.  
  949.     
  950.     def set_defaults(self, **kwargs):
  951.         self.defaults.update(kwargs)
  952.  
  953.     
  954.     def _get_all_options(self):
  955.         options = self.option_list[:]
  956.         for group in self.option_groups:
  957.             options.extend(group.option_list)
  958.         
  959.         return options
  960.  
  961.     
  962.     def get_default_values(self):
  963.         if not self.process_default_values:
  964.             return Values(self.defaults)
  965.         
  966.         defaults = self.defaults.copy()
  967.         for option in self._get_all_options():
  968.             default = defaults.get(option.dest)
  969.             if isbasestring(default):
  970.                 opt_str = option.get_opt_string()
  971.                 defaults[option.dest] = option.check_value(opt_str, default)
  972.                 continue
  973.         
  974.         return Values(defaults)
  975.  
  976.     
  977.     def add_option_group(self, *args, **kwargs):
  978.         if type(args[0]) is types.StringType:
  979.             group = OptionGroup(self, *args, **kwargs)
  980.         elif len(args) == 1 and not kwargs:
  981.             group = args[0]
  982.             if not isinstance(group, OptionGroup):
  983.                 raise TypeError, 'not an OptionGroup instance: %r' % group
  984.             
  985.             if group.parser is not self:
  986.                 raise ValueError, 'invalid OptionGroup (wrong parser)'
  987.             
  988.         else:
  989.             raise TypeError, 'invalid arguments'
  990.         self.option_groups.append(group)
  991.         return group
  992.  
  993.     
  994.     def get_option_group(self, opt_str):
  995.         if not self._short_opt.get(opt_str):
  996.             pass
  997.         option = self._long_opt.get(opt_str)
  998.         if option and option.container is not self:
  999.             return option.container
  1000.         
  1001.  
  1002.     
  1003.     def _get_args(self, args):
  1004.         if args is None:
  1005.             return sys.argv[1:]
  1006.         else:
  1007.             return args[:]
  1008.  
  1009.     
  1010.     def parse_args(self, args = None, values = None):
  1011.         rargs = self._get_args(args)
  1012.         if values is None:
  1013.             values = self.get_default_values()
  1014.         
  1015.         self.rargs = rargs
  1016.         self.largs = largs = []
  1017.         self.values = values
  1018.         
  1019.         try:
  1020.             stop = self._process_args(largs, rargs, values)
  1021.         except (BadOptionError, OptionValueError):
  1022.             err = None
  1023.             self.error(str(err))
  1024.  
  1025.         args = largs + rargs
  1026.         return self.check_values(values, args)
  1027.  
  1028.     
  1029.     def check_values(self, values, args):
  1030.         return (values, args)
  1031.  
  1032.     
  1033.     def _process_args(self, largs, rargs, values):
  1034.         while rargs:
  1035.             arg = rargs[0]
  1036.             if arg == '--':
  1037.                 del rargs[0]
  1038.                 return None
  1039.                 continue
  1040.             if arg[0:2] == '--':
  1041.                 self._process_long_opt(rargs, values)
  1042.                 continue
  1043.             if arg[:1] == '-' and len(arg) > 1:
  1044.                 self._process_short_opts(rargs, values)
  1045.                 continue
  1046.             if self.allow_interspersed_args:
  1047.                 largs.append(arg)
  1048.                 del rargs[0]
  1049.                 continue
  1050.             return None
  1051.  
  1052.     
  1053.     def _match_long_opt(self, opt):
  1054.         return _match_abbrev(opt, self._long_opt)
  1055.  
  1056.     
  1057.     def _process_long_opt(self, rargs, values):
  1058.         arg = rargs.pop(0)
  1059.         if '=' in arg:
  1060.             (opt, next_arg) = arg.split('=', 1)
  1061.             rargs.insert(0, next_arg)
  1062.             had_explicit_value = True
  1063.         else:
  1064.             opt = arg
  1065.             had_explicit_value = False
  1066.         opt = self._match_long_opt(opt)
  1067.         option = self._long_opt[opt]
  1068.         if option.takes_value():
  1069.             nargs = option.nargs
  1070.             if len(rargs) < nargs:
  1071.                 if nargs == 1:
  1072.                     self.error(_('%s option requires an argument') % opt)
  1073.                 else:
  1074.                     self.error(_('%s option requires %d arguments') % (opt, nargs))
  1075.             elif nargs == 1:
  1076.                 value = rargs.pop(0)
  1077.             else:
  1078.                 value = tuple(rargs[0:nargs])
  1079.                 del rargs[0:nargs]
  1080.         elif had_explicit_value:
  1081.             self.error(_('%s option does not take a value') % opt)
  1082.         else:
  1083.             value = None
  1084.         option.process(opt, value, values, self)
  1085.  
  1086.     
  1087.     def _process_short_opts(self, rargs, values):
  1088.         arg = rargs.pop(0)
  1089.         stop = False
  1090.         i = 1
  1091.         for ch in arg[1:]:
  1092.             opt = '-' + ch
  1093.             option = self._short_opt.get(opt)
  1094.             i += 1
  1095.             if not option:
  1096.                 raise BadOptionError(opt)
  1097.             
  1098.             if option.takes_value():
  1099.                 if i < len(arg):
  1100.                     rargs.insert(0, arg[i:])
  1101.                     stop = True
  1102.                 
  1103.                 nargs = option.nargs
  1104.                 if len(rargs) < nargs:
  1105.                     if nargs == 1:
  1106.                         self.error(_('%s option requires an argument') % opt)
  1107.                     else:
  1108.                         self.error(_('%s option requires %d arguments') % (opt, nargs))
  1109.                 elif nargs == 1:
  1110.                     value = rargs.pop(0)
  1111.                 else:
  1112.                     value = tuple(rargs[0:nargs])
  1113.                     del rargs[0:nargs]
  1114.             else:
  1115.                 value = None
  1116.             option.process(opt, value, values, self)
  1117.             if stop:
  1118.                 break
  1119.                 continue
  1120.         
  1121.  
  1122.     
  1123.     def get_prog_name(self):
  1124.         if self.prog is None:
  1125.             return os.path.basename(sys.argv[0])
  1126.         else:
  1127.             return self.prog
  1128.  
  1129.     
  1130.     def expand_prog_name(self, s):
  1131.         return s.replace('%prog', self.get_prog_name())
  1132.  
  1133.     
  1134.     def get_description(self):
  1135.         return self.expand_prog_name(self.description)
  1136.  
  1137.     
  1138.     def exit(self, status = 0, msg = None):
  1139.         if msg:
  1140.             sys.stderr.write(msg)
  1141.         
  1142.         sys.exit(status)
  1143.  
  1144.     
  1145.     def error(self, msg):
  1146.         self.print_usage(sys.stderr)
  1147.         self.exit(2, '%s: error: %s\n' % (self.get_prog_name(), msg))
  1148.  
  1149.     
  1150.     def get_usage(self):
  1151.         if self.usage:
  1152.             return self.formatter.format_usage(self.expand_prog_name(self.usage))
  1153.         else:
  1154.             return ''
  1155.  
  1156.     
  1157.     def print_usage(self, file = None):
  1158.         if self.usage:
  1159.             print >>file, self.get_usage()
  1160.         
  1161.  
  1162.     
  1163.     def get_version(self):
  1164.         if self.version:
  1165.             return self.expand_prog_name(self.version)
  1166.         else:
  1167.             return ''
  1168.  
  1169.     
  1170.     def print_version(self, file = None):
  1171.         if self.version:
  1172.             print >>file, self.get_version()
  1173.         
  1174.  
  1175.     
  1176.     def format_option_help(self, formatter = None):
  1177.         if formatter is None:
  1178.             formatter = self.formatter
  1179.         
  1180.         formatter.store_option_strings(self)
  1181.         result = []
  1182.         result.append(formatter.format_heading(_('Options')))
  1183.         formatter.indent()
  1184.         if self.option_list:
  1185.             result.append(OptionContainer.format_option_help(self, formatter))
  1186.             result.append('\n')
  1187.         
  1188.         for group in self.option_groups:
  1189.             result.append(group.format_help(formatter))
  1190.             result.append('\n')
  1191.         
  1192.         formatter.dedent()
  1193.         return ''.join(result[:-1])
  1194.  
  1195.     
  1196.     def format_epilog(self, formatter):
  1197.         return formatter.format_epilog(self.epilog)
  1198.  
  1199.     
  1200.     def format_help(self, formatter = None):
  1201.         if formatter is None:
  1202.             formatter = self.formatter
  1203.         
  1204.         result = []
  1205.         if self.usage:
  1206.             result.append(self.get_usage() + '\n')
  1207.         
  1208.         if self.description:
  1209.             result.append(self.format_description(formatter) + '\n')
  1210.         
  1211.         result.append(self.format_option_help(formatter))
  1212.         result.append(self.format_epilog(formatter))
  1213.         return ''.join(result)
  1214.  
  1215.     
  1216.     def _get_encoding(self, file):
  1217.         encoding = getattr(file, 'encoding', None)
  1218.         if not encoding:
  1219.             encoding = sys.getdefaultencoding()
  1220.         
  1221.         return encoding
  1222.  
  1223.     
  1224.     def print_help(self, file = None):
  1225.         if file is None:
  1226.             file = sys.stdout
  1227.         
  1228.         encoding = self._get_encoding(file)
  1229.         file.write(self.format_help().encode(encoding, 'replace'))
  1230.  
  1231.  
  1232.  
  1233. def _match_abbrev(s, wordmap):
  1234.     if wordmap.has_key(s):
  1235.         return s
  1236.     else:
  1237.         possibilities = _[1]
  1238.         if len(possibilities) == 1:
  1239.             return possibilities[0]
  1240.         elif not possibilities:
  1241.             raise BadOptionError(s)
  1242.         else:
  1243.             possibilities.sort()
  1244.             raise AmbiguousOptionError(s, possibilities)
  1245.  
  1246. make_option = Option
  1247.